ccmd

Stop memorizing commands. Start commanding naturally.

ccmd is a cross-platform terminal command manager. Define short, intuitive aliases for the commands you type every day — then just type them.

Works on Linux, Windows PowerShell, and WSL.

---

Install

pip install ccmd
ccmd --install   # one-time shell integration

---

The idea

Instead of this:

cd ~/projects/myapp && git add . && git commit -m "update" && git push

You write this:

push

ccmd replaces long, forgettable terminal syntax with commands you define yourself — stored in YAML, backed up automatically, and safe to roll back.

---

What you get out of the box

Command	What it does
go <dir>	Jump to any directory by name — searches your entire system
push	Interactive git add, commit, and push in one command
cpu	Live CPU usage
mem	Memory usage
proc	Running processes
add	Create a custom command interactively
remove	Remove a custom command
list	View and toggle commands on/off
reload	Reload config without reinstalling
restore	Roll back shell changes

---

Custom commands

ccmd add

You'll be prompted for a name, a shell command, and whether it needs a password. That's it. Your custom commands live in ~/.ccmd/custom_commands.yaml and survive all future updates.

Command chaining — use >>> to chain multiple commands under one name:

# Define once
ccmd add
> name: devstart
> command: go projects >>> ls >>> echo "ready"

# Then just type:
devstart

---

Real-world example

# Instead of this every morning:
cd ~/work/api && git pull && docker compose up -d && echo "Running"

# Define it once:
ccmd add
> name: work
> command: go api >>> git pull >>> docker compose up -d

# Then just type:
work

---

Security

ccmd sits between you and your shell. It was built with that in mind.

• Atomic shell config writes — no corruption on crash
• 40+ command injection patterns blocked automatically
• Optional master password (bcrypt) for sensitive commands
• Automatic backup before every shell modification
• Full rollback with ccmd --restore at any time
• Audited with Bandit, Safety, and CodeQL — 0 HIGH severity issues

Full threat model: THREAT_MODEL.md

---

Update

pip install --upgrade ccmd

Uninstall

ccmd --restore   # removes shell integration
pip uninstall ccmd

---

License

MIT — free to use, fork, and modify.

---

Built by De Catalyst · @iamdecatalyst